home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / amiex / stopcps.lha / STopCPS / STOPCPS_V1.06.DOC < prev   
Text File  |  1993-01-18  |  13KB  |  273 lines
  1. Compared to the wholescale  violence  of  capital and government,  political
  2. acts of violence are but a  drop in the  ocean...  High strung like a violin
  3. string, [the anarchists] weep and moan for life, so relentless, so cruel, so
  4. terribly inhuman. In a desperate moment the string breaks. Emma Goldman,1910
  5.  
  6. Super-TopCPS - Top CPS Recorder for /X - Docs, Code, Output ⌐1993 P0T-NOoDLE
  7. ============================================================================
  8. Features:    Does NOT lose CPS Records when you cut your CallersLog!
  9.         MultiNode Compatable (And of course single node too).
  10.         FAST & SMALL 680x0 Assembler Coding! (AND I MEAN FAST!)
  11.         Beautiful & Informative Output! Look at Example output.
  12.         Upto a Top-20 with UserName,BaudRate,Filename,CPS-Speed...
  13.         Pure, re-entrant code (resident-able).
  14.         Gunna format your harddrive (NOT).
  15.  
  16. Mini-Index
  17. ==========------------------------------------------------------------------
  18.     1    Command Line
  19.     2    Command: D-ocs
  20.     3    Command: C-Lear
  21.     4    Command: U-pdate
  22.     5    Command: O-utput
  23.     6    Command Stacking
  24.     7    Note: CPS Rates in Storage File
  25.     8    Thanx & Mini-Greetings
  26.     9    Slagging off for this util
  27.     10    BBS Numbers for Contact/BugReports/Etc
  28.     11    Program Release History
  29.     12    BOLLOX
  30.  
  31.  
  32.  
  33. COMMAND LINE
  34. ============----------------------------------------------------------------
  35.     Super-TopCPS  has a very  flexible command line.  You may have it do
  36. many operations in just one run by using command stacking (See below).  Each
  37. command is always preceeded with a "-", eg "-C" is command "C".  Most of the
  38. commands also have extra options and requirements.
  39.     Output filenames may NOT contain either "-" or " ".
  40.     Output filenames are converted to uppercase, not that it matters.
  41.     Entering an Output filename of "*" will output to your CLI window.
  42.  
  43.     While reading the  docs on  each command,  I advise that you also be
  44. looking at the CommandLine help text for the Command templates. (Now there's
  45. something you can't do on a fucking PC (or a toy(games console!))).
  46.  
  47.  
  48.  
  49. Command D-ocs
  50. =============---------------------------------------------------------------
  51.     This command creates this doc file by uncrunching it from the Super-
  52. TopCPS code and outputing it to the specified filename.  The  example  would
  53. output the docs to `RAM:STC.DOC'
  54.  
  55. STopCPS -D"RAM:STC.DOC"
  56.  
  57.     By the way,  this is done so that  the util is never spread  without
  58. it's docs,  and so there is never the age old question of  HOW THE FUCK DOES
  59. THIS WORK  when  you're  setting up  a board  from  someone's  HD-Backup  or
  60. whatever.  It does not  slow down  the program  at all,  and as the docs are
  61. crunched,  memory loss is hella-small  (You'd lose  three times as much just
  62. by using a shitty C program instead of STC!).
  63.  
  64.  
  65.  
  66. Command C-lear
  67. ==============--------------------------------------------------------------
  68.     This will create a new and blank storage file  if it does not exist,
  69. or blank the already  existing  storage file.  A storage file  must  be made
  70. before Commands U and O will work.
  71.     The storage file is called `S:STopCPS.Store'  and is where STC keeps
  72. all its information about the fastest 20 uploads and downloads.
  73.  
  74. Example: STopCPS -C
  75.  
  76.  
  77.  
  78. Command U-pdate
  79. ===============-------------------------------------------------------------
  80.     This will check the  last caller  to your board for any  uploads  or
  81. downloads  which were  fast enough to get them into your Top-20.  If any are
  82. found, they will be added into the Storage file.
  83.     You must run this Command everytime someone logs off a node.
  84.     U-pdate  requires  the node number  which you wish  to update (0-9).
  85. Example1  would be used  after a user  has just  logged off Node0.  Example2
  86. would be used after a user has just logged off Node1.
  87.  
  88. Example1: STopCPS -U"0"
  89. Example2: STopCPS -U"1"
  90.  
  91.     Note that  you can  use one logoff  script for all of your  nodes by
  92. putting  `.k node'  at the start of your logoff script, and having  `<NODE>'
  93. in place of the node number. See the included example logoff script.
  94.  
  95.     NOTE: Due to the way that  STC  looks for the Baud Rates you have to
  96. have your HST set to output FULL connect strings,  like any non-idiot would.
  97. (eg "CONNECT 9600/ARQ/HST/HST/V42BIS" NOT "CONNECT 9600")
  98.  
  99.  
  100.  
  101. Command O-utput
  102. ===============-------------------------------------------------------------
  103.     This command outputs a list of all time fastest transfers, using the
  104. info in the storage file.  You must give it an output path and the number of
  105. users you wish to be displayed (0-20).
  106.     Example1 will output the top 10 users to `RAM:TEST_BULL'.
  107.     Example2 will output the top 20 users to `BBS:NODE0/BULL100.TXT.GR'
  108.  
  109. Example1: STopCPS -O"RAM:TEST_BULL"10
  110. Example2: STopCPS -O"BBS:NODE0/BULL100.TXT.GR"15
  111.  
  112.                                              O-utput - Header & Tailer texts
  113. ---------------------------------------------===============================
  114.     If  `S:STopCPS.Header.txt(.gr)'  exists, it will be added to the top
  115. of the output, and if  `S:STopCPS.Tailer.txt(.gr)'  exists, it will be added
  116. to the end of the output.  The ".gr" is dependant on  Option N being On/Off.
  117.  
  118.                                                   O-utput - Option N: NoANSI
  119. --------------------------------------------------==========================
  120.     This option removes all ANSI codes from the text and slightly alters
  121. the output so that it will look better without the ANSI. It will replace the
  122. "|"'s in the header line with "-"'s etc.
  123.     This option also effects what Header/Tailer text is used (See above)
  124.     The Example  will output  the top 20 speeds to  `RAM:BULL' ,  with a
  125. NoANSI output, and add `S:STopCPS.Header.TXT' &/or `S:STopCPS.Tailer.TXT' if
  126. either/both exist.
  127.  
  128. Example: STopCPS -ON"RAM:BULL"20
  129.  
  130.                                      O-utput - Option U: UpperCase Filenames
  131. -------------------------------------=======================================
  132.     This option converts all the filename texts in the output into upper
  133. case.  In my opinion it looks  better this way,  but some people may wish to
  134. have the filenames left as they were originally.
  135.     The Example will output the top 5 speeds to  `T:FISHFINGER'  with an
  136. ANSI output,  and filenames in UpperCase, adding `S:STopCPS.Header.TXT' &/or
  137. `S:STopCPS.Tailer.TXT' if either/both exist.
  138.  
  139. Example: STopCPS -OU"T:FISHFINGER"5
  140.  
  141.                                            O-utput - Option T: Text Dissable
  142. -------------------------------------------=================================
  143.     This option simply ignores and does not use the Header/Tailer texts
  144. in S:. Simple.
  145.     The Example will output the top 3 speeds to `RAM:ERP' without ANSI,
  146. and with Uppercase filenames, and will NOT add any Head or Tail texts, even
  147. if they do exist.
  148.  
  149. Example: STopCPS -ONUT"RAM:ERP"3
  150.  
  151.  
  152.  
  153. Command Stacking
  154. ================------------------------------------------------------------
  155.     A user has just logged off node 1. You his/her transfers checked and
  156. added to the store file if needed,  and you also want to update the ANSI and
  157. non-ANSI TopCPS lists in the Amiga conf bulletins directory. No problem:
  158.  
  159. STopCPS -U"1" -O"BBS:Ami/Bulls/Bull1.TXT.GR" -ON"BBS:Ami/Bulls/Bull1.TXT"
  160.  
  161.     Should be pretty clear to the non-stupid among you.
  162.  
  163.  
  164.  
  165. Note
  166. ====------------------------------------------------------------------------
  167.     The  CPS  rates in the  Storage  file are  checked  for tempering by
  168. cheating sysops. So don't change them, and also, don't touch my name!
  169.  
  170.  
  171.  
  172. THANX
  173. =====-----------------------------------------------------------------------
  174.     They all know who they are and why there are here,  but for the rest
  175. of you, I must thank the following people, without whom STopCPS would not be
  176. what it is.
  177.  
  178. Squiz                 - Who wrote a TopCPS  Util in Basic for me a long time
  179.                       - ago (obviously before he left the scene!) from which
  180.                       - I've borrowed ideas,some of which were mine to start
  181.                       - with.
  182. Thrash   of   Anthrox - Technical Assistance and Disk Drives!
  183. Fay of the real world - <Insert musshy B.S. which has all been said before!>
  184. Bluelight             - Quick Bug Reporting & Sending Logs/Outputs with it!
  185.  
  186. My other friends & group members in the scene.
  187. My other friends & family outside of the scene.
  188.  
  189. And, In No Duck-Fucking-Order... Oranges,Bananas,Fish Fingers,Beef Curtains,
  190. Your Mum,Pepsi,Pizza,Metallica,Megadeth-?,Anthrax,Slayer,C.O.C,Ugly Kid Joe,
  191. Faith No More,Nine-Inch Nails,D.R.I,Exodus,MortalSin,OverKill,Paradox,Toxik,
  192. Flotsam and Jetsam,Lawnmower Deth,Testament,Xentrix,Venom,Re-Animator,S.O.D,
  193. Nuclear Assault,Guns'n'Roses,Possessed,Skid Row,Onslaught,MorotHead,Pantera,
  194. and people who talk like this: "swark swark swark swark" That's you that is.
  195.  
  196. FUCK THE REST OF THE WORLD
  197.  
  198.  
  199.  
  200. P0T'S NOTE FOR THIS UTIL:
  201. =========================---------------------------------------------------
  202.     Aimed at people who make and use Archive-BBSAd-Adders that strip the
  203. other adds.  You idiots  are so fucking hypocritical.  If you dissagree with
  204. BBS Ads that's fine, strip them all. BUT, if you strip and then add your own
  205. BBS Ad, you are  STUPID!  Think about this. If we all did this, when someone
  206. downloads a file from a BBS, they simply get the add from that BBS.  I don't
  207. think that anyone's users need to be asked to call a board that they already
  208. call??  Or, do you think that you're Board is so special that it should have
  209. it's ad and  noone else's in the file!?  Or is your Board so  shit  that you
  210. wanna remove other adds so that it looks like it got the file first??
  211.     Whatever the reason,  if you strip AND add,  you're a stupid,  lame,
  212. no-thinking,  idiotic person,  and you will probably end up raping your  own
  213. children after your sex-partner gets a pair of glasses.
  214.  
  215.     Also,  stupid  assholes  who strip the  front text from DMS files or
  216. "*.displayme" from LHAs are extra-extra-STUPID! These texts may (or may not)
  217. contain important information about the archive they are in.  Nearly all the
  218. utilities  indiscriminately  delete these files,  whether they are important
  219. info or just another BBS-Ad.
  220.     While I'm on the subject, DMS-Boot-Block adds are a nice idea, pitty
  221. that the util-makers didn't fucking think. What if it's a fix or part b of a
  222. disk or whatever? Not all,but some of the Boot-Block adders don't check that
  223. the DMS file will actually write the  correct bootblock  after the Add-Block
  224. has been written. EG: If it's a fix that  doesn't change  the bootblock, the
  225. fix is written and the  propper bootblock  of the disk has a  BBS-Ad written
  226. all over it,  thus totally screwing up the disk and getting someone a little
  227. bit pissed off! IT'S STUPID! DON'T DO IT!
  228.  
  229.                      To the person who did that little "Ultimate Util" Joke:
  230. ---------------------=======================================================
  231. HAHAHA You make me laugh man! I don't know whether to be mad at you or what?
  232. Well, I take it as a joke, a fucking wierd one! Nice try, YOU MUTHERFUCKER!!
  233.  
  234.  
  235.  
  236. Contact
  237. =======---------------------------------------------------------------------
  238.     If you can call England, drop me a message on...
  239. <./\.|    (Anthrox UKHQ) +44-813466842 Sysop:P0T-NOoDLE
  240.     Or if you can't, call...
  241. Martyrium (Anthrox USHQ) +713-460-8217 Sysop:Wintermute (5 nodes-Ringdown)
  242.  
  243.     Contact me if you have any bug reports or ideas on any of our utils,
  244. or if you have a cool idea for a new util that you want written.
  245.  
  246.  
  247.  
  248. History
  249. =======---------------------------------------------------------------------
  250. Version - Release Number -------------------------------------- Release Date
  251. v1.00 ===-[01]-================================================ 2nd Jan 1993
  252.     Initial Release.
  253. v1.05 ===-[02]-=============================================== 16th Jan 1993
  254.     BUG FIX: If someone leeched and got a TopCPS, and the next caller
  255.              did not upload at all, he would get the same speed/filename
  256.              or he would get a wierd username. (I'm Hella-Stupid!)
  257.     O-utput and C-lear routines almost completely re-written.
  258.     Information output to CLI about operations performed.
  259.     New O-utput Oution: T - Dissables header/tailer texts.
  260. v1.06 ===-[03]-=============================================== 18th Jan 1993
  261.     BUG FIX: Root-Dir Download paths do not mess up filenames anymore.
  262. ============================================================================
  263.     About this release, in detail:
  264. When working out the name of downloaded  files from the callerslog, the util
  265. previously searched for "/" and would take the word after it,  assuming that
  266. all files would be  downloaded  from  a  directory  and not a root-dir or an
  267. assign (such as "Dh1:" or "FILES:". This was stupid, I know! Now it searches
  268. for a "/" OR a ":" and should work fine!
  269.     Thanx (or no thanx!)  to  Bluelight  for once again finding this bug
  270. in record time (how long was it,  3 hours since release?) and sending me the
  271. callerslog so that I could discover the obvious and stupid mistake I'd made!
  272. ============================================================================
  273.